StdLine

The default Quickdraw line-drawing routine

#include <Quickdraw.h> Quickdraw

void StdLine(endPoint );

Point endPoint ; where to end the line (starts at pnLoc)

This is Quickdraw's default low-level routine for drawing lines. The line is

drawn starting at pnLoc, using the pnSize, pnMode, pnPat, pnVis, and fgColor

fields of the current GrafPort.

endPoint is the Point, in local coordinates, to which a line is drawn. Upon

return, thePort->pnLoc has been set to this value.

Notes: Use StdLine only if your application intercepts the Quickdraw bottleneck

routines (see SetStdProcs).

The line is drawn according to the pnMode (a pattern transfer mode),

pnPat (a pattern), and pnSize fields of the current grafPort. Output is

clipped to the portBits.bounds, portRect, visRgn, and clipRgn. Also, if

pnVis is less than 0, nothing is drawn.

If you're currently defining a polygon (see OpenPoly), StdLine adds

endPoint to its definition; if you're recording a picture (see

OpenPicture), the function adds the line to its definition.

Since, Quickdraw already uses highly-optimized line-drawing algorithms,

there is little reason to intercept this routine.

Referenced by (3):